.TH stoker_wake 8 "5 September 2008" "version 0.91" "Stoker Manual"
.SH NAME
stoker (wake) \- use Wake-On-Lan to start remote hosts
.SH SYNOPSIS
.B stoker
[OPTIONS] <machine(s)> wake [options]

.B stoker
<\-a | \-\-all> [OPTIONS] wake [options]
.SH DESCRIPTION
The stoker(8) wake command uses Wake-On-Lan with "magic packets" to wake
remote machines from ACPI S3 or S4 sleep states.
Global OPTIONS, including selection of parallel operation, are documented
in the man page for stoker(8).
.SH COMMAND OPTIONS
.TP
.B \-b \-\-broadcast <address>
Broadcast address to use.
If unspecified, the broadcast address will be read from stoker.conf(5).
.TP
.B \-d \-\-delay <seconds>
Wait <seconds> seconds after sending the WOL packet(s) to one machine, before
sending the WOL packet(s) to the next machine among the targets.
This option is only effective if stoker(8) is in sequential mode.
.TP
.B \-p \-\-port <port>
Port number to which the "magic packets" should be sent.
If omitted, the default port number will be used from stoker.conf(5).
.TP
.B \-t \-\-tries <num>
Send the "magic packet" <num> times.
.SH SERVER REQUIREMENTS
The targeted machines must be configured for the stoker(8) wake command
to function correctly. 
The motherboard of each machine must support Wake-On-Lan functionality.  
Wake-On-Lan must be enabled in the BIOS of the target machines, and the 
operating system must also enable WOL functionality. 
See ethtool(8).  
.SH CONFIGURATION REQUIREMENTS
The broadcast address must be set either in stoker.conf(5) or as a command
option.
Also, every target to be awakened MUST be resolvable to MAC address using
the defined Stoker machine sources (see stoker(8) for more information).
.SH EXAMPLE
.TP
Wake all known machines using broadcast address 192.168.0.255:
.B stoker -a wake -b 192.168.0.255
.SH EXIT STATUS
Stoker returns a zero exit status if it can successfully SEND the "magic
packets."
A non-zero exit status will occur if needed information, such as
the broadcast address and target MAC address, cannot be found.
.SH SEE ALSO
stoker(8), ethtool(8)
.SH AUTHOR
Mike Murphy (mamurph@cs.clemson.edu)

Joshua Canter (jcanter@clemson.edu)
.SH DISCLAIMER
This material is based upon work supported under a National Science
Foundation Graduate Research Fellowship.
Any opinions, findings, conclusions or recommendations expressed in this
publication are those of the author(s) and do not necessarily reflect the
views of the National Science Foundation.
